home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Business Heaven
/
Business Heaven.iso
/
network
/
doc_proc
/
tapecopy.doc
< prev
next >
Wrap
Text File
|
1992-11-16
|
19KB
|
251 lines
*************************************
* *
* T A P E C O P Y *
* ON THE MVS/XA OPERATING SYSTEM *
* *
*************************************
John S. Ward
03/15/93
EJECT
The TAPECOPY procedure generates JCL to copy data sets on a library
or foreign, standard or non labeled tape to a library or foreign,
standard or non labeled tape.
INVOL - The volume serial number of the input tape.
Required
INLBL - The label type of the input tape, SL or NL.
Default: SL
INEXPDT - The expiration date of the input tape. See member
TMSINFO in in SYS.MVS.UPDATE for information about
expiration dates.
Default: 99000
OUTVOL - The volume serial number of the output tape.
Default: none, Required if OUTEXPDT is 98000
OUTLBL - The label type of the output tape, SL or NL.
Default: SL
OUTEXPDT - The expiration date of the output tape. See member
TMSINFO in in SYS.MVS.UPDATE for information about
expiration dates.
Default: 99000
CNTL - The fully qualified data set name of a table describing
the input tape data sets.
Default: none, Required if 98000/NL INVOL
DSN - The data set name of the 1st data set on the tape
Required if INEXPDT = 98000 and no CNTL
FSQN - The file sequence numbers of the data sets to copy.
FSQN must be enclosed in quotes if specified.
Default: all files on input tape
HIQUAL - The hi-level qualifier for the output tape data set
names.
Default: USERID
MIDQUAL - The mid or 2nd level qualifier for the output tape data
set names.
Default: none
OUTLST - Flag that instructs TAPECOPY to place listing of the
tape in HIQUAL.TCZZZ999.OUTLST(Linvol)
Default: off
SUB - Flag that instructs TAPECOPY to submit the Tapecopy
job from the generated JCL in :
HIQUAL.TCZZZ999.TAPECOPY(TCinvol).
Default: off
EJECT
If the input tape is a library (99000) tape the user may build a
control file or they may submit a run sheet to PCG. If the input tape
is a private (98000) standard labeled tape the user may run TAPECOPY
themselves without a control file. If the input tape is a private non
labeled tape the user must supply a control file. TAPECOPY will always
use a control file if it is supplied. There are 13 parameters to
TAPECOPY, but in most cases default values will be used for all but a
few parameters.
LIBRARY TAPES
If the input volume is a library tape , there are two options. The
user may submit a run sheet to the I/O window to request that PCG
(Production Control Group) run the procedure. The run sheet should
specify all parameters the user wishes passed to the TAPECOPY procedure
including HIQUAL. PCG will run the TAPECOPY procedure which will place
the desired JCL in:
HIQUAL.TCZZZ999.TAPECOPY(TCinvol)
The user may then inspect the JCL and possibly modify it before
submitting it. Note that it is the responsibility of the user to submit
the JCL generated. PCG will not submit it. The turnaround time on a
run sheet submitted to PCG is 24 hours.
The other option is to create a control file that describes the data
set on the input volume. This method will allow the user to immediately
generate and submit the JCL. The format of the control file is:
n DATA.SET.NAME RECFM LRECL BLKSIZE
'n' is either the file sequence number of the data set on the input
tape or a '*'. A '*' represents the file sequence number of the
previous table entry plus one.
The user may obtain the necessary file sequence and DCB information
by running either a TINFO or requesting an OPRTINFO job on the input
tape (see member TAPEINFO in SYS.MVS.UPDATE). The difficult part may
be in finding the full dsname of the input data sets. Standard tape
labels contain only the last 17 characters of the data set name and non
labeled tapes have no data set names on the tape. For security reasons
the tape management system knows the full name of all data sets in its
catalog, and it will not allow access to that data set unless the
correct full data set name is given. PCG has the authority to scan the
tape management system catalog for the full data set name which users
do not have. If the input tape data sets are catalogued the full
dsname is available in ISPF screen 3.4.
EJECT
PRIVATE TAPES
If the input tape is a private (EXPDT=98000) standard labeled tape
the user must supply the data set name of the first file on the tape
in the DSN parameter. If the input tape is non labeled a CNTL
parameter must be passed.
If TAPECOPY is run without a control file it will submit a job with
job characters TI, which will pull the necessary information from the
tape to create the JCL to copy the tape. The actual tapecopy job has
job characters TC.
TAPECOPY generates data set names for the output tape in the form
HIQUAL.MIDQUAL.Fnnn. HIQUAL defaults to the invoking userid or the
user may pass it as a parameter. The user must have RACF authority to
write to that high level qualifier. HIQUAL must be 6 or 7 characters.
MIDQUAL is an optional but recommended parameter that describes the
contents of the tape. If the generated output data set names are
unsatisfactory, edit the generated JCL found in
HIQUAL.TCZZZ999.TAPECOPY(TCinvol). Change the DSN in the SYSUT2 DD
statements to the preferred data set name and submit the job. Please
note that data set names must be unique. If the user copies two tapes
and uses the same hi level qualifier and mid level qualifier the second
job run will have a return code of 0 but the output data sets will not
be catalogued because there is already a catalog entry with that name.
The user should not pass the FSQN parameter if a CNTL data set is
specified. That information is in the table. The user should not pass
the FSQN parameter if they wish to copy all the data sets on a tape.
FSQN may be a list and/or range of file sequence numbers. FSQN('9')
FSQN('1,3,8') FSQN('1,4-7,9') are all valid examples.
Output data sets on library (99000) tapes are catalogued. Output
data sets on foreign (98000) data sets are not catalogued.
EJECT
EXAMPLES:
1. If standard labeled library tape 7001 contains the data sets:
USERID.THESIS.DATA1
USERID.THESIS.DATA2
USERID.THESIS.DATA3
The user submits a run sheet requesting:
TAPECOPY INVOL(007001) HIQUAL(USERID) MIDQUAL(THESISBK)
PCG will run TAPECOPY which will place JCL in
USERID.TCZZZ999.TAPECOPY(TC007001) that will write a standard
labeled library tape with the catalogued data sets:
USERID.THESISBK.F001
USERID.THISISBK.F002
USERID.THESISBK.F003
when submitted.
If the user prefers, they may build a control file, run TAPECOPY,
and submit the tapecopy job immediately.
Write USERID.TAPE.CNTL containing:
* USERID.THESIS.DATA1 FB 80 3120
* USERID.THESIS.DATA2 FB 80 6240
* USERID.THESIS.DATA3 FBA 133 3192
Run TAPECOPY
TAPECOPY INVOL(007001) CNTL(USERID.TAPE.CNTL) OUTVOL(FOREIGN)
OUTLBL(NL) OUTEXPDT(98000)
This will create a foreign non labeled tape appropriate for mailing
to another site.
If USERID.TAPE.CNTL contained instead:
2 USERID.THESIS.DATA2 FB 80 6240
* USERID.THESIS.DATA3 FBA 133 3192
only the 2nd and the 3rd data sets would be copied.
2. TAPECOPY INVOL(FOREIGN) INLBL(SL) INEXPDT(98000) DSN(DATA.SET.NAME)
FSQN('1,3,4-9,23,45-60') OUTLST SUB
Will copy the data sets specified in the FSQN from a foreign
standard labeled tape to a standard labeled library tape. The job
will automatically be submitted because of the SUB parameter, and a
list of the the output tape will be written to:
HIQUAL.TCZZZ999.OUTLST(FOREIGN)